Suggest adding newlines at end of sentence. That way, even if an earlier sentence is later amended, only that sentence needs to be reformatted and later sentences in the same paragraph need not be affected. E.g.

The *fundchannel* RPC command opens a payment channel with a peer by commiting
a funding transaction to the blockchain as defined in BOLT #2.
Once the transaction is confirmed, normal channel operations may begin.
Readiness is indicated by *listfunds* reporting a `short_channel_id` for
the channel.

Then later if we amend it:

The *fundchannel* RPC is a totally radical command that opens a really cool payment
channel with a peer by commiting a funding transaction to the blockchain as defined
in the outrageously awesome BOLT #2.
Once the transaction is confirmed, normal channel operations may begin.
Readiness is indicated by *listfunds* reporting a `short_channel_id` for
the channel.

listchannels, despite its name, lists all channels known in the public network, i.e. the entire routemap. Local channels are listed in listpeers.

Yes, we should probably start an effort at some point to give unique error codes for some of the more complex commands. Since it is a JSON-RPC change this will probably have to be done pre-0.6 release too. This is fine for now though; we can update the docs later when we finally have unique error codes.

Yeah that's what I was thinking.